swagger: '2.0'
info:
  description: 
    ${swagger.info.description}
  version: ${swagger.info.version}
  title: ${swagger.info.title}
  contact:
    email: ${swagger.info.contact.email}
  license:
    name: ${swagger.info.license.name}
    url: ${swagger.info.license.url}
host: ${swagger.host}
basePath: ${swagger.basePath}
tags:
  <#list swagger.tags as tag>
  - name: ${tag.name}
    description: ${tag.description}
  </#list>
schemes:
  <#list swagger.schemes as scheme>
  - ${scheme}
  </#list>
paths:
  <#list swagger.paths as pathElement>
   ${pathElement.path}:
     ${pathElement.method}:
      tags:
        - ${pathElement.tag}
      summary: ${pathElement.summary}
      description: ${pathElement.description}
      operationId: ${pathElement.operationId}
      produces:
    <#list pathElement.produces as produce>
        - ${produce}
    </#list>
      parameters:
        - name: id
          in: path
          description: 用户ID，用来作为查询主键
          required: true
          type: integer
      responses:
        '200':
          description: 成功返回
          headers:
            X-Rate-Limit:
              type: integer
              format: int32
              description: 每小时运行调用次数
            X-Expires-After:
              type: string
              format: date-time
              description: 'token过期时间, UTC格式'
        '400':
          description: 非法的请求
        '401':
          description: 非法用户认证
        '404':
          description: 没有找到该请求服务
        '500':
          description: 系统异常操作
</#list>
securityDefinitions:
  api_key:
    type: apiKey
    name: api_key
    in: header
    description: 接口调用授权使用api key